home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / KSLIB11.ARJ / READ.ME < prev    next >
Text File  |  1991-11-13  |  5KB  |  96 lines
  1.                KSLIB version 1.1, release date 13-Nov-91
  2.  
  3.             Copyright 1991 Kevin Spencer, Digital Services.
  4. -------------------------------------------------------------------------------
  5. I retain full copyright on the software contained in this archive.
  6.  
  7. Permission is hereby granted to copy and/or distribute this software, as long
  8. as no charge is made for such copying or distribution excepting any reasonable
  9. amount for media, mailing, and evaluation. This software may be embedded in
  10. a compiled application program sold for profit, as long as the libraries
  11. themselves are not part of the sale. The source code (if you have it) may
  12. not be distributed.
  13.  
  14. You may use this software for a reasonable period for evaluation, but if you
  15. find it useful, the registration fee is $20AUS, payable to :
  16.  
  17. Kevin Spencer
  18. 17 Winchelsea Rd
  19. NOLLAMARA
  20. WESTERN AUSTRALIA  6061
  21.  
  22. If you are using foreign currency, and can't get it converted, figure it out
  23. pretty close. I'm not worried about a couple of dollars either way. I'll
  24. accept anything except cash (Anything I can convert to cash at the local
  25. bank anyway). I'll even accept cash if you want to risk it not getting to me.
  26.  
  27. Registered users will receive a free copy of new versions for 12 months,
  28. through either E-mail or Snail-mail, as well as preference on any improvement
  29. suggestions. How long it takes for the next release depends mainly on how many
  30. people register.
  31.  
  32. The source to this software is available for $50AUS. Same conditions as above
  33. regarding foreign currency and acceptable payment methods. Source won't be
  34. released to non-registered users.
  35.  
  36. This software is provided as-is, and no claim, expressed or implied, is made
  37. as to it's suitability for any given purpose. Use it at your own risk. I'm
  38. not responsible for any damages (I can't think of a good legalese way of
  39. saying that).
  40.  
  41. -------------------------------------------------------------------------------
  42. Edit History :
  43. ---------------
  44. 01-Sep-91    Version 1.0 released
  45.             -    Yecch. Full of warnings. Ok for a first attempt I suppose.
  46. 13-Nov-91    Version 1.1 released
  47.             -    Now compiles with no warnings, with Turbo-C being as strict
  48.                 as I can make it.
  49.             -    Database library radically modified to improve speed -
  50.                 Unfortunately, its not backward compatible, although the
  51.                 differences are minor unless you're using multiple indexes
  52.                 per file. If you are, be patient. They'll be put back in for
  53.                 version 1.2 in a month or two.
  54.             -    More functions added, plus another library.
  55.             -    Various improvements made to many functions.
  56.             -    Documentation improved.
  57. -------------------------------------------------------------------------------
  58. To compile :
  59. -------------
  60. Make sure Turbo-C is in your path, then type 'make demo1' or 'make demo2'
  61. to compile either of the two demos, or 'make all' to compile both.
  62.  
  63. For normal use, place the header files in your include directory, the library
  64. files in your library directory, and compile your programs as per normal,
  65. making sure you include the appropriate files in your source, and link the
  66. libraries at link-time.
  67.  
  68. Note that all the library names end in 'L'. This is because they were all
  69. built using the Large memory model. I'd like to make them usable with all
  70. memory models, but I haven't figured out how yet. The first stage will be
  71. for me to build them successfully using the Tiny memory model, then go from
  72. there. If this occurs in a future release, the tiny model libraries will all
  73. end in 'T'. Eventually (when I make them model-independent), the suffix will
  74. be removed completely.
  75.  
  76. -------------------------------------------------------------------------------
  77. Header files :
  78. ---------------
  79. All functions must have the appropriate header files included. You could
  80. get away without it on some, but it is advised against. In view of this,
  81. I'm not going to tell you which ones are safe :-)
  82.  
  83. In general, functions beginning with capital letters use the header file
  84. consisting of those letters. ie, WNback() uses wn.h. The rest of the functions
  85. you'll need to look up. These are generally the miscellaneous functions.
  86.  
  87. Also, most (if not all) the functions refer to values defined in stdinc.h,
  88. such as TRUE, FALSE, etc. Therefore, you should include this file if you are
  89. using *any* of these functions.
  90.  
  91. One other header file is scancode.h. This contains #defines for the scan codes
  92. returned by the keyboard. It was originally part of kk.h, but I found I was
  93. using it in other modules, so I gave the defines their own file.
  94.  
  95. -------------------------------------------------------------------------------
  96.